home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 034a / zodiac34.zip / ZODIAC.DOC < prev    next >
Text File  |  1992-02-16  |  9KB  |  213 lines
  1.  
  2.  
  3.                       Zodiac DOOR program for PCBoard 14.x
  4.                                    Release 3.04
  5.                                 February 16, 1992
  6.  
  7.  
  8.  
  9.                 Written by - Roland Haley
  10.                 Rural Route #7  Woodstock
  11.                 Ontario  N4S  7W2  Canada
  12.  
  13.  
  14.  
  15.  
  16.  
  17.               HALEY'S COMMENT BULLETIN BOARD
  18.                  USRobotics HST 9600-baud
  19.                   (519) 469-3028
  20.                                   (519) 469-3173
  21.                                   (519) 539-6851
  22.  
  23.  
  24.         This program not only works as a fun door for your users, but
  25.         also a utility for you to recognise your users birthday and to
  26.         make you a Horoscope bulletin. The door gives your users an
  27.         interpretation of their birth sign and biorythms. They can also
  28.         enter a friend or relatives name to find out their particular
  29.         horoscope.
  30.  
  31.         The utility allows you to wish your users a happy birthday on
  32.         their date and it also makes a bulletin of that months
  33.         horoscope.
  34.  
  35.         To run the utility, you must enter a couple of lines in your
  36.         EVENT.SYS file. for example you must direct the event to the
  37.         area where ZODIAC.EXE resides and then use the command
  38.  
  39.                                       Example:
  40.  
  41.         CD\DOORS\ZODIAC      <== Goes to where the door resides
  42.         ZODIAC BIRTHDAY      <== Runs ZODIAC.EXE birthday utility
  43.  
  44.  
  45.                                       Format for Birthday List:
  46.  
  47. *mmddyyyy Birthdays
  48. *-------- ------------------------------------------------------------
  49. B03031942 Roland Haley SysOp of Haley's Comment BBS.
  50.                                                                        
  51.  
  52.  
  53.  
  54.                      DOOR Setup
  55.  
  56.       Make a batch file to run the DOOR as described in your PCBoard
  57.       (R) documentation.
  58.  
  59.                       Example:
  60.  
  61.           CD \DOORS\ZODIAC   <== Goes to where the program resides
  62.           ZODIAC ZODIAC.CFG  <== Runs ZODIAC.EXE passing a parameter of ZODIAC.CFG
  63.           CD \PCB                An example of this file is below.
  64.       BOARD
  65.  
  66.  
  67.                          Example ZODIAC.CFG file:
  68.  
  69.  
  70.       C:\PCB\PCBOARD.SYS          <== The location of this file
  71.       Haley's Comment BBS         <== The name of your BBS
  72.       Roland                      <== The SysOps FIRST name
  73.       Haley                       <== The SysOps LAST name
  74.       0                           <== Registration number
  75.           CAN                         <== Date format (Canadian) or change to US
  76.           C:\EVENT\TODAY.LCL          <== Path to the birthday list
  77.           C:\PCB\NEWS                 <== Path to the birthday greeting file
  78.           100                         <== Max number of lines for greeting file
  79.           C:\PCB\ZODIAC\BLT-1         <== Path to the Horoscope bulletin
  80.  
  81.  
  82.                                 Environment Variables
  83.  
  84.  
  85.       Two environment variables must be set in your AUTOEXEC.BAT file:
  86.  
  87.           SET LIB=<drive:><path to DORPCH35.EXE>  Note: ONLY the PATH !
  88.  
  89.       Example:  SET LIB=C:\MYLIB
  90.  
  91.           The DORPCH35.EXE run-time library must then be placed in this
  92.       directory.  If you keep the library in the <current directory>
  93.       with the DOOR program then this environment variable is NOT
  94.       required.  I would suggest a separate directory - perhaps a
  95.       RAMDISK as I do on my system.
  96.  
  97.  
  98.           SET DOORPCH=PCB     This variable tells DORPCH35.EXE it is
  99.                   running on a PCBoard system
  100.  
  101.  
  102.           All DOORPCH 3.5 DOORS require the DORPCH35.EXE run-time library
  103.       and the Microsoft (R) QuickBASIC 3.0 run-time library,
  104.       BRUN30.EXE, be present.  Your DOOR program may have come with
  105.           these files in the ZIP file.  If they are not present, this DOOR
  106.       program WILL NOT RUN.  You should contact the DOOR author if the
  107.       files are missing.  You require one and only one version of these
  108.           two libraries for ALL DOORPCH 3.5 DOORware.  The files are also
  109.           available in DORPCH35.ZIP available on most PCBoard Bulletin
  110.       Board Systems.  If you wish a fully detailed explanation of how
  111.       DOORPCH operates with DOORS, then you may read the documentation
  112.           within the DORPCH35.ZIP file within which this documentation may
  113.       be found.
  114.  
  115.                    DOOR Operation
  116.  
  117.       When the DOOR is in operation you have complete control over the
  118.           caller.  This DOOR was written using DOORPCH version 3.5.  The
  119.       logic is safe.  However, if something goes wrong - like real bad
  120.       wrong, sorry but we probably can't help.  Every precaution has
  121.       been taken to insure this code works flawlessly.  If it doesn't,
  122.       let us know.  Many function/operational keys are at your
  123.       disposal/use:
  124.  
  125.       F1   -    Displays the version of DOORPCH compiled and linked
  126.             into the DOOR.
  127.       F2   -    Displays a callers Alias if one is used via the Door
  128.             Monitor program (DOORPCH version) - future.
  129.       F3   -    Reserved for the future.
  130.       F4   -    Toggles the Bell on/off. May activate the DOOR Bell.
  131.             Value is returned to PCBoard when DOOR completes.
  132.       F5   -    DOS Shell. Allows SysOp to exit to DOS from inside a
  133.             DOOR.
  134.       F6   -    Displays available MEMORY and available STRING space.
  135.       F7   -    Toggle the alarm on/off. May activate the DOOR Alarm.
  136.             Value is returned to PCBoard when DOOR completes.
  137.       F8   -    Returns the caller involuntarily to PCBoard.
  138.       F9   -    Toggles the display on/off.
  139.             Value is returned to PCBoard when DOOR completes.
  140.       F10  -    Activates SysOp / Caller CHAT mode within the DOOR.
  141.       ESC  -    Deactivates CHAT mode. DOOR is resumed.
  142.       HOME -    HELP key for line 24/25 capabilities.
  143.       END  -    Displays Callers name and miscellaneous information.
  144.       PG-DN-    Displays Data Phone, Home Phone, Security Level
  145.             Uploads, Downloads and Expiration Date.
  146.       PG-UP-    Displays Comments from the callers USER record.
  147.       UP -      Allows the SysOp to temporarily add additional time
  148.             to the caller while in the DOOR. This time is NOT
  149.             returned to the BBS.
  150.       DN -      Allows the SysOp to temporarily subtract time from the
  151.             caller while in the DOOR. This time is NOT returned
  152.             to the BBS.
  153.       ALT-N -   SysOp next on control/indicator.
  154.             Value is returned to PCBoard when DOOR completes.
  155.       ALT-X -   PCBoard will exit after current caller completes their
  156.             session.  Value is returned to PCBoard when DOOR
  157.             completes.
  158.  
  159.       If you are running in NON-GRAPHICS mode, you MUST have ANSI.SYS
  160.       installed as a device driver in your CONFIG.SYS file:
  161.  
  162.                   Example: DEVICE=ANSI.SYS
  163.  
  164.       DOORPCH uses this device driver for displaying all colors to the
  165.       local console.  Color Graphics will always be sent to the local
  166.       console if you have defined to PCBSetup that you are running
  167.       graphics on the local monitor.  If a caller is in non-graphics
  168.       mode (NG) on line 25,  you will still see colors if PCBSetup has
  169.       been configured  that way.  The reverse is also true.  If the
  170.       caller is in graphics mode (GR) on line 25) and the local console
  171.       is defined to be in non-graphics mode then colors will NOT be
  172.       displayed to the local console.
  173.  
  174.  
  175.                     BELL
  176.  
  177.       DOORPCH logic will not allow a BELL to be sent to the local
  178.       console when the local screen is inactive (F9 OFF).
  179.  
  180.  
  181.  
  182.  
  183.  
  184.                        ERRORS
  185.  
  186.       All errors should recover and cause the DOOR program to exit
  187.       gracefully and return to the main system.  All errors are logged
  188.       in the "DOORPCH.ERR" file. The error number and line number are
  189.       included with the date and time.  Errors will be either caused by
  190.       the main module (the authors code, contact him) or the doorpch
  191.       sub (contact DOORPCH people).  It should NEVER cause the board to
  192.       hang.  If your board hangs, you are obligated to contact the
  193.       appropriate party and report the error and circumstances that
  194.       caused it.  Because we are using Microsoft's (c) QuickBASIC 3.0
  195.       run-time routines, it is possible that basic will detect a fatal
  196.       error condition.  As mentioned above, we have taken every
  197.       precaution, but simply cannot code for every error condition.
  198.       The Door should run without error.
  199.  
  200.  
  201.  
  202.  
  203.       If you are running this door on your system, and find it to be
  204.       entertaining. Please register your copy by sending $20 to:
  205.  
  206.                  HALEY'S COMMENT BBS
  207.                     R.R.#7
  208.                   Woodstock, Ontario
  209.                   Canada     N4S 7W2
  210.  
  211.       Include the exact display name of your BBS for your registration
  212.           number to be placed in the ZODIAC.CFG file.
  213.